package com.example.archive.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.example.archive.entity.Training;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Select;

import java.util.List;

/**
 * 培训资料数据访问层接口
 * 继承MyBatis Plus的BaseMapper，提供基础CRUD操作
 * 同时定义自定义查询方法
 */
@Mapper
public interface TrainingMapper extends BaseMapper<Training> {
    
    /**
     * 查询所有已发布的培训资料
     * 关联查询users表获取上传者姓名
     * 当name为null时使用username作为显示名称
     * 按上传时间倒序排列
     * 
     * @return 已发布的培训资料列表
     */
    @Select("SELECT t.*, COALESCE(u.name, u.username) as uploader_name FROM trainings t " +
            "LEFT JOIN users u ON t.uploader_id = u.user_id " +
            "WHERE t.status = 'published' ORDER BY t.upload_time DESC")
    List<Training> selectPublishedTrainings();
    
    /**
     * 分页查询所有培训资料（管理员使用）
     * 关联查询users表获取上传者姓名
     * 当name为null时使用username作为显示名称
     * 按上传时间倒序排列
     * 
     * @param page MyBatis Plus分页对象
     * @return 分页查询结果
     */
    @Select("SELECT t.*, COALESCE(u.name, u.username) as uploader_name FROM trainings t " +
            "LEFT JOIN users u ON t.uploader_id = u.user_id " +
            "ORDER BY t.upload_time DESC")
    Page<Training> selectTrainingsWithUploader(Page<Training> page);
} 